home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / mus / play / edplyr21.lha / EdPlayer.DOCs / EdP2.1.Intro.README_FIRST < prev    next >
Text File  |  1992-09-20  |  13KB  |  257 lines
  1.  
  2. ============================================================================
  3.                          EdPlayer version 2.1
  4.                              by Ed Mackey
  5. ============================================================================
  6.  
  7. All new releases and upgrades of PD/Shareware/Freeware by Ed & Al Mackey
  8. (such as EdPlayer) are uploaded FIRST to our official support BBS:
  9.      ____   __          ___  ___  _____  __   
  10.     /      /  \ |\  /| |__  |___)   |   /  \ |\ |           __________
  11.     \____  \__/ | \/ | |___ |  \    |   \__/ | \|             /   /
  12.        __\______  ___       ___  ___  __                     /   /
  13.      ____/ |     |__  |    |__  /    /  \ |\  /| |\  /|   __/___/__
  14.            |     |___ |___ |___ \___ \__/ | \/ | | \/ |
  15.            |
  16.            |    Modem: (215) 464-6775       HST: (215) 464-4461
  17.  
  18.  Supporting:    Amiga/IBM/Mac/][gs/UNIX     Storage:    670 Megabytes
  19.  Active Nodes:  9 (more coming soon)        Location:   Philadelphia, PA
  20.  Baud Rates:    3/12/24/48/96/14.4 (HST)    Graphics:   ANSI/IBM/SkyPix
  21.  
  22.  Features:      Teleconferencing            Global 'GO' Commands
  23.                 Multi-Player Games          Inter-User Chatting
  24.                 Live Conference RPG's       ANSI & Skypix Pictures
  25.                 Areas on ALL Topics         Special Over & Under 18 Bases
  26.                 Friendly Staff              Hundreds of Active Users
  27.  
  28. ============================================================================
  29.  
  30. The sysop of Somerton is Eric Parkin, a good friend of mine.  If you call
  31. his board in the evening or at night, there's a chance you might meet me
  32. or Al (or both) messing around in the live teleconference area.  Such fun
  33. it is to have a BBS that understands multitasking, and has so many phone
  34. lines going into it.  It's running on an Amiga with a 25MHz '030.
  35. But enough about that...  You came here to read about EdPlayer...
  36.  
  37. ----------------------------------------------------------------------------
  38.  
  39. ORGANIZATION OF THESE FILES:
  40.     These docs are organized so that you don't have to read all of them at
  41. once, but can skip to the part you want or need.  Aren't you glad??
  42. As of v2.0, I have split the DOCs into separate files:
  43.  
  44. EdP2.1.Intro.README_FIRST
  45.     -- This file.  Please read!!  Then you can fiddle with the buttons.
  46. EdP2.1.Buttons.DOC
  47.     -- After you fiddled, read this if you don't "get it".
  48. EdP2.1.LEDs.DOC
  49.     -- What all the blinking things mean.
  50. EdP2.1.Commands.DOC
  51.     -- Another way of controlling EdP.  ARexx is OPTIONAL!
  52. EdP2.1.ErrorCodes.DOC
  53.     -- Errors and POSSIBLE CAUSES!  Read if/when you get one.
  54.  
  55. NOVICE AMIGA USERS:  Don't be scared by the "ARexx" section!!  You don't
  56. need to know anything about ARexx itself to use EdPlayer commands, in
  57. fact, you don't even NEED ARexx (although it's recommended).  Please
  58. glance at this section.  There are many useful commands, and a lot of
  59. EdPlayer's functions that are too complicated for a simple point-and-click
  60. panel are stored here.
  61.  
  62. ============================================================================
  63.  
  64.                           I N T R O D U C T I O N
  65.  
  66. ============================================================================
  67.  
  68. Hello, and welcome to EdPlayer!!
  69.  
  70. First, distribution:  EdPlayer is shareware.  You can distribute it by any
  71. means, including BBSs, PD disks, and FTP services like AB20, etc.  You can
  72. also distribute EdPlayer with your own programs, as long as you include a
  73. note that EdPlayer is freely distributable, and do not make any copyright
  74. claims on EdPlayer.  If you want to distribute EdPlayer with a commercial
  75. package, please contact me first (address at end of document).  I would
  76. LIKE for you to keep these docs with EdPlayer whenever possible, because
  77. many important things are explained here (like EdPlayer's ARexx interface)
  78. that aren't explained anywhere else.  However, if you MUST distribute
  79. EdPlayer without this file, you may.  Also, note that if you distribute the
  80. kd_freq.library, you MUST keep its DOC file with it.  This is explained
  81. later in this file, in the "Buttons" section under "OPEN", the only button
  82. that uses the kd_freq.library.
  83.  
  84. The new EdPlayer Junior has the same distribution terms as EdPlayer.
  85.  
  86.            EdPlayer and EdPlayerJr are copyright 1992 Ed Mackey.
  87. ----------------------------------------------------------------------------
  88.  
  89. BUT, what IS it??
  90.  
  91. EdPlayer is a music player.  It can play both NoiseTracker modules and
  92. MED version 3.21 (or greater??) modules.  Note that SOME MED 3.00 modules
  93. will work also, however, others will show up as "Unknown or corrupt module"
  94. because MED 3.00 had a serious bug in the module-saving routines (it didn't
  95. word-align the chunks sometimes, and caused other MED players to GURU, but
  96. EdPlayer has a check for this and will only report a "corrupt module"
  97. error).  To fix a MED 3.00 or earlier module, simply load it into MED 3.21
  98. and save it back out as a MODULE.  As far as #?Tracker modules go, I
  99. am now using the ProTracker 1.1b replay routine by Lars "Zap" Hamre/Amiga
  100. Freelancers 1991.  This may make some old NT mods not work properly
  101. anymore, but I think that PT mods are far more popular by now.
  102.  
  103. What EdPlayer can be used for:
  104.  
  105. I had MANY uses in mind as I was designing EdPlayer.  I wanted a music
  106. player that could be used directly for entertainment, or multitask while
  107. the user did word-processing or whatever, and also be able to run from both
  108. ARexx and CLI scripts for use in IFF slide shows, presentations with
  109. background music (AmigaVision, DVideo III, Director 2, etc.), music for
  110. games written in AmigaBasic or other languages for which there are no
  111. music-playing routines available, and basically any situation at all where
  112. someone wants their Amiga to play some tunes.   ;->
  113.  
  114. EdPlayerJr is a small version of EdPlayer, one that has no main panel.
  115. It can be controlled from ARexx, telled, cteled, etc.  It is very
  116. good in low-mem conditions, because it only takes a few bytes of
  117. CHIP mem, leaving most of the memory free for mods.  It is also good
  118. for presentations that don't need the main panel, etc.  You can even
  119. create programs (lists of songs) in the main EdPlayer and play them
  120. back with EdPlayerJr.
  121.  
  122. EdPlayerJr tries to be as compatible as possible with the main EdPlayer
  123. except for the lack of the panel.  Almost all the same ARexx commands
  124. work, the same startup script is used, etc.  Even the version numbers
  125. are the same so you can keep matching versions of EdPlayer and
  126. EdPlayerJr together.
  127.  
  128. ----------------------------------------------------------------------------
  129. Starting EdPlayer:  There are four ways to start EdPlayer...
  130.  ---> (1) Workbench Icon.        Brings up some CD-player like controls.
  131.       (2) CLI: "run EdPlayer"    Also brings up the CD controls.
  132.       (3) CLI: "run EdPlayer -i" Brings up a tiny "iconified" WB window.
  133.       (4) CLI: "run EdPlayer -h" NO user interface, ARexx port ONLY!
  134.  
  135. Note that I recommend using the "runback" command rather than "run" if you
  136. have it, so that the CLI window itself can close before EdPlayer does.
  137. NOTE: A simmilar effect can be achieved with "run <NIL: >NIL: EdPlayer".
  138.  
  139. Note that ALL 4 startup methods open the EDPLAYER message port, which can
  140. accept instructions from AREXX (if you have it) as well as the "telled"
  141. command explained in the ARexx section.
  142.  
  143.              *************** STARTUP SCRIPTS *****************
  144.  
  145. As of version 2.0, EdPlayer now attempts to run a startup script IF
  146. ARexx is present when EdP is launched.  The startup script should be
  147. called REXX:Startup.EdP.  An example startup script is contained in
  148. this archive; please modify that to your liking rather than attempting
  149. to create one from scratch.  If you create one from scratch you might
  150. forget some features or something, whereas the provided startup shows
  151. how to set everything.  Of course, if you know all the ARexx commands,
  152. feel free to make one from scratch.
  153.  
  154. Please don't distribute modified startups.
  155. ----------------------------------------------------------------------------
  156.  
  157. OK, now that you know how to run it, you can start playing with it even
  158. before you finish reading these DOCs.  This is because there is an ONLINE
  159. HELP FUNCTION that is self-explanatory.  However, this function includes a
  160. lot of scrolling text, and so when you get tired of reading that, you can
  161. come back here because ALL OF THE ONLINE HELP IS ALSO AVAILABLE HERE IN THE
  162. DOCs.  Plus, some features, like the AREXX port, are ONLY described here in
  163. the DOCs!!
  164.  
  165. ============================================================================
  166.  
  167. Well, go on, play with the buttons; I know it's killing you to sit here
  168. reading this DOC file when you could be messing with new software.
  169.  
  170. ============================================================================
  171.  
  172. OK, so by now you should have some experience with EdPlayer, and if you
  173. bothered to come back here and read this (I hope you did!!) then
  174. you get to see my address and other cool stuff (don't you feel lucky).
  175.  
  176. I personally really hate programs who's DOC files are as big or
  177. bigger than the program itself, and so I'm not too happy about the fact
  178. that despite all my efforts to make this thing user-friendly, I still wound
  179. up with MonsterDOCs.
  180.  
  181. ----------------------------------------------------------------------------
  182.  
  183. If you use EdPlayer, or ESPECIALLY if you would like to use EdPlayer but
  184. there's some little vital feature missing that's stopping you, then I WANT
  185. to hear from you!!
  186.  
  187. For instance, if you have, say, an ASM source code that plays mods
  188. much better than the player built into EdPlayer, send me a copy!  I'll see
  189. if I can include it in the next release or not...  (This is assuming you
  190. can legally send me this copy, and I can legally use it!  If not, DON'T.)
  191.  
  192. At this point I'm also going to suggest maybe possibly sending me a
  193. donation, if you like EdPlayer or want to see improved versions of it.  I'm
  194. not going to expect everyone who sends me mail to give a donation, just the
  195. people who want to see EdPlayer improve, or have found it useful.  Most
  196. people so far have decided to send me $10 for a donation.  That seems
  197. to be a reasonable price.
  198.  
  199. **** DISK OFFER ****
  200.     I am now mailing disks to anyone who contributes $10 or more to
  201. EdPlayer.  The disk contains the latest version of EdPlayer, a little
  202. hack called the "Program Manager", and a bunch of mods by my brother
  203. Al (that are not available in the public domain).  Be sure to mention
  204. EdPlayer (I've had one or two people send me money and not mention
  205. which of my programs they were paying for)!
  206.  
  207. Also I'm open to comments & suggestions about almost every aspect of the
  208. program, with the possible exception of people who think that naming the
  209. "EdPlayer" after myself was an egotistical, stuck-up move.  It's only a
  210. $10 program.  And I'm not a creative naming genius, obviously.  If you think
  211. YOU are, send your much-improved names, money, software, and/or comments to:
  212.  
  213. US mail:                Ed Mackey
  214.                         PO Box 475
  215.                         Wayne, PA 19087
  216.                            * USA *
  217. Or:
  218.     Internet:  ELM4@Lehigh.edu  <== NOTICE, new address from last version!
  219.     IRC: LineNoise
  220.  
  221.     Somerton Telecomm BBS email (see top of this document): Ed Mackey
  222.     Somerton BBS conference room: LineNoise
  223.  
  224. As you might have guessed from the network address, I'm a student at
  225. Lehigh University in Bethlehem, PA.  I've just started my senior
  226. year at Lehigh, being a Computer Science major.  This message was written
  227. on Sep 19, 1992.  I may not be at Lehigh after '93, and I may even move my
  228. home address from Wayne, PA before then, so I didn't provide EITHER of
  229. those US mail addresses here.  The only one I provided is the PO Box in
  230. Wayne (above), which I will keep EVEN if I move, so that address should be
  231. valid for years and years to come.
  232.  
  233. About my brother, Al Mackey:  He just graduated from High School and is
  234. now going to Rider college.  (Good luck Al!!)  He and I work together
  235. on programs, usually splitting the workload as follows:  All code - me.
  236. All music - Al.  All graphics - first drawn by Al and then modified
  237. and rearranged by myself, making the gfx sort of a 50%/50% project.  This
  238. is the way we did our game Ball, our game MegaBall (Fred Fish #477), and
  239. also this project (EdPlayer).  I'm sorry I can't really distribute a bunch
  240. of Al's great music with this program, but I'm trying to keep the archive
  241. as small as I reasonably can.  Of course, with my new disk offer (above),
  242. you can get a bunch of Al's mods for just $10.  Al and I split the money.
  243.  
  244. Al does all the demosongs for EdPlayer.  He also draw the new 2.0 icon
  245. for EdPlayer, showing one of his new cartoon characters that doesn't
  246. officially have a name yet.  And NO, that's not meant to be
  247. Amy the squirrel!  (Someone already asked this!)
  248.  
  249. Al now has email and FTP access.  You can reach him via:
  250.     Internet:  MACKEY@enigma.rider.edu
  251.     Bitnet:    MACKEY@RIDER.BITNET
  252.  
  253. ----------------------------------------------------------------------------
  254.  
  255. Thanks for downloading EdPlayer.  Hope you like it....
  256.                                                        --Ed.
  257.